home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / source / fadecode / readmeor.els < prev    next >
Encoding:
Text File  |  1994-08-19  |  13.1 KB  |  343 lines
  1. ╒═══════════════════════════════════════════════════════════════════════════╕
  2. │                                                                           │
  3. │  *****  FadeCode         *****                                            │
  4. │                                                                           │
  5. │    By Esak     (Aug 19, 1994)                                             │
  6. ╘═══════════════════════════════════════════════════════════════════════════╛
  7.  
  8. ══════════════════════════════════════════════════════════════════════════
  9. A sad legal ***p
  10.  
  11.   I make no warranty whatsoever regarding this product. I assume no 
  12.  responsiblity for any malicious impact on you, your computer, your red 
  13.  blood cell production, or the sanity of the presidential candidate you 
  14.  supported during the last election, made by the use or misuse of this 
  15.  product.
  16. ══════════════════════════════════════════════════════════════════════════
  17.  
  18.  
  19. Hi there,
  20.  
  21.   I decided to release the code for a number of different palette effects. 
  22. I will be the first to admit that it's not a Future Crew demo source code, 
  23. or anything vaguely close to earth-shattering. But I belive this release may 
  24. be useful to some beginning programmers. Learn from it if you can. Rip this 
  25. off if you want. You may even include source in your own library as long as 
  26. your library is a freeware as well. I won't ask for any credit. I am not 
  27. overly proud for this release anyway. But if you find this useful, a 
  28. postcard would be nice, though.
  29.  
  30.  
  31. ══════════════════════════════════════════════════════════════════════════
  32. Files
  33. ══════════════════════════════════════════════════════════════════════════
  34. FADE_C.C            It contains higher level interface routines which calls 
  35.             some of the routines included in FADE.ASM.
  36. FADE.ASM            This is the main module that contains a bunch of
  37.             palette manipulating routines. 
  38. *.OBJ               OBJ files. Compiled for large model.
  39. MODEL.INC           Include file for FADE.ASM
  40.             Change this if you would like to compile under a 
  41.             different memory model. 
  42. FADE.H              Header file for C
  43.  
  44.  
  45. FADEDEMO.C          A sample program demonstrating the use of the included
  46.             functions. Link with FADE_C.C and FADE.ASM.
  47. FADEDEMO.PRJ        Project file I used to link this program.
  48. FADEDEMO.EXE        The executable.
  49.  
  50.  
  51. SCREEN.RAW          320*200 raw image file used by FADEDEMO
  52. PAL1.pal            palette file used by FADEDEMO
  53. PAL2.pal            palette file used by FADEDEMO
  54.  
  55. READMEOR.ELS        You are reading this.
  56. README.1st          You read it before.
  57.  
  58.  
  59. ═════════════════════════════════════════════════════════════════════════
  60. A quick intro to VGA palette format (For a newbie)
  61. ══════════════════════════════════════════════════════════════════════════
  62. You (hopefully) know a VGA card can use 256 color at once. A VGA card 
  63. needs three bytes of information for each color. One byte for red
  64. intensity. One byte for green intensity. And one byte for blue intensity.
  65. So data for a complete 256 color VGA color palette amounts to 768 bytes
  66. total.
  67.  However, only six bit from each byte is used. So each byte can have a
  68. value between 0..63.
  69.  Well, that's all I can and need to tell you now.
  70.  
  71.  
  72. ══════════════════════════════════════════════════════════════════════════
  73. Bresenham Algorithm
  74. ══════════════════════════════════════════════════════════════════════════
  75. One of the tricky problems that arise as you program palette fading is:
  76.   SMOOTH TRANSITION FROM ONE COLOR TO ANOTHER
  77.  
  78. Simulating fade in etc, requires smooth transition from one color to
  79. another. I have seen someone using floating point math to do this. For
  80. graphic coders, floating point math is an evil that must be avoided.
  81.   So what's the solution? The famous/infamous Bresenham Algorithm. This
  82. is commonly known as line algorithm, but this algorithm pops up almost
  83. every corner in graphics programming world.
  84.   Let's say you need to change the value of a byte from 2 to 23. And you must
  85. do changing 32 times. With floating math, it would be
  86.  
  87.   the_byte=0;
  88.  loop 32 times begin
  89.   the_byte=the_byte+43/23
  90.  loop end
  91.  
  92.   However, using Bresenham algorithm, it would be:
  93.  
  94.   the_byte=2
  95.   Decision_variable=0
  96.   loop 32 times begin 
  97.    Decision_variable=Decision_variable+(23-2)
  98.    if Decision_variable<32 
  99.     begin
  100.      the_byte=the_byte+1
  101.      Decision_variable=Decision_variable-32
  102.     end
  103.   loop end
  104.  
  105.  It may look more complicated. But using B-algorithm is a LOT faster than
  106. using floating point math. But as you can see, we need one more decision
  107. variable for each variable we want to change. Therefore, many of the routines included
  108. here use additional 768 bytes to implement smooth color transition.
  109.  
  110.  
  111.  
  112. ══════════════════════════════════════════════════════════════════════════
  113. Functions in FADE_C.C
  114. ══════════════════════════════════════════════════════════════════════════
  115.  
  116.  void fade_screen(void far *pal)
  117.    >it calls fade_once() 32 times.
  118.    >the content of the palette array is not preserved.
  119.  
  120.  void fade_in_screen(void far *pal)
  121.    >it calls fade_in_once() 32 times.
  122.    >the content of the palette array is preserved.
  123.  
  124.  void bright_screen(void far *pal)
  125.    >it calls bright_once() 32 times
  126.    >the content of the palette array is not preserved.
  127.  
  128.  void bright_in_screen(void far *pal)
  129.    >it calls bright_in_once() 32 times
  130.    >the content of the palette array is preserved.
  131.  
  132.  void fade_between_screen(void far *pal,void far *pal_dest)
  133.    >It call fade_between_once() 64 times
  134.    >pal[] and pal_dest[] both have to be 768 bytes (chars) long
  135.    >The content of neither palette array is preserved. However, the
  136.     content of pal_dest[] will be moved to pal[].
  137.  
  138. Please look at FADEDEMO.C to get a better idea of how to use the routines
  139. in FADE_C.C.
  140.  
  141.  
  142.  
  143. ══════════════════════════════════════════════════════════════════════════
  144. Functions in FADE.ASM
  145. ══════════════════════════════════════════════════════════════════════════
  146.  
  147.  
  148.  void setPal(void far *pal)
  149.    >*pal points to an array of 768 bytes (chars) that contains
  150.  
  151.  void fill_pal(void far *pal,char red, char green,char blue);
  152.    >Fills the palette array with the given color information
  153.  
  154.  void copy_pal(void far *pal,void far *pal_dest);
  155.    >Copies one palette to another
  156.  
  157.  void rotate_pal(void far *pal,char index,char numCol, char displacement);
  158.    >Note this carefully.
  159.    >This routine DOES preserve the content of pal[]
  160.    >Let me give you some examples to explain how this routine works.
  161.  
  162.    >rotate_pal(&pal,63,32,0);
  163.     This routine will update palette number from 63-95.
  164.     But no rotation will take place
  165.  
  166.    >rotate_pal(&pal,63,32,1);
  167.     This routine will also update palette number from 63-95.
  168.     But this time, the color #64 will replace the content of color #63
  169.     and color #65 will replace #66 etc.
  170.  
  171.  
  172.  void sub_palette(void far *pal,void far *pal_dest);
  173.    >Subtracts one palette from another. You have to call this function
  174.    >before calling fade_between_once() If you are not going to call 
  175.    >fade_between_once() directly, you have no business calling this 
  176.    >routine.
  177.  
  178.  
  179. In most cases, you WON'T have to call the following functions.
  180. I will explain when you have to use these functions. Please look at
  181. FADE_C.C. That would be the best way to learn how to use the following
  182. functions.
  183.  
  184.  void fade_out_once(void far *pal)
  185.    >Changes the content of the palette array
  186.    >Should be called 32 times to turn the screen completely black.
  187.  
  188.  void bright_out_once(void far *pal)
  189.    >ditto
  190.  
  191.  void fade_in_once(void far *pal,void far *pal_dest)
  192.    >ditto
  193.    >*pal shoul point to an array of 768*2 *BLANK* chars, not 768 chars.
  194.    >The second half of pal[768*2] will be used as decision variables
  195.     for Bresenham algorithm.
  196.    >After calling it 32 times, the content of pal[] will be identical
  197.     to the content of pal_dest[]
  198.  
  199.  void fade_between_once(void far *pal,void far *pal_dest)
  200.    >sub_palette() must be called before calling this function.
  201.    >*pal shoul point to an array of 768*2 chars, not 768 chars.
  202.    >The second half of pal[768*2] will be used as decision variables
  203.     for Bresenham algorithm.
  204.    >After calling it 32 times, the content of pal[] will be identical
  205.     to the content of pal_dest[]
  206.  
  207.  
  208. You have to use a *something*_once() routines when you want to
  209. update palette while animating at the same time. What you do is something
  210. like this:
  211.  
  212. n=32;
  213. do
  214.   animate_sprite_or_whatever();
  215.   ....
  216.   if(n>0)
  217.    fade_once(&pal);
  218.    n=n-1;
  219.   ....
  220. while (not_finished)
  221.  
  222.  
  223.  
  224. ══════════════════════════════════════════════════════════════════════════
  225. What's to be done.
  226. ══════════════════════════════════════════════════════════════════════════
  227. First of all, all of the routines included in this file change entire
  228. 256 color palette. I didn't write routines which can be used to change
  229. a portion of palette. For most applications, you won't have to. (Especially
  230. since these routine run snow-free on every machine I tested so far.)
  231.   But if you need to, I will leave this task for asn exercize for you. If
  232. you are a half-way descent ASM programmer, it wouldn't be hard.
  233.   Beside, that's what source code is for: to modify. Well, I admit that my
  234. assembly routines could use more documentation, though.
  235.   If anyone ports these codes to 32bit Pmode, please let me know.
  236.  
  237.  
  238.  
  239. ══════════════════════════════════════════════════════════════════════════
  240. To fellow coders
  241. ══════════════════════════════════════════════════════════════════════════
  242.  
  243. I have a very fast local bus VGA card. This toy allowed me to play _Strike
  244. Commander_ on my 486/25. The problem is that many games demos exhibit
  245. intolerable amount of snow when they change palette.
  246.  
  247. I see strong evidences that many programmers are still sending palette data
  248. byte by byte. (out dx,al) I use this command instead.
  249.  
  250.     rep   outsb
  251.  
  252. This rep outsb command format has been around since 80286 came out. For
  253. Christssake, use it!
  254.  I update 128 colors (384 bytes) at once and I get no snow on my video card.
  255. (Updating 256 color at once gave me little snow, though.)
  256.  
  257. I am getting sick and tired of seeing snow on so many games and demos (Except
  258. for some exceptions like _Zone66_.) If you don't want to use my routine for
  259. palette fading, at least use rep outsb for updating palette.
  260.  
  261.  
  262.  
  263. ══════════════════════════════════════════════════════════════════════════
  264. About me
  265. ══════════════════════════════════════════════════════════════════════════
  266. I am a first year computer engineering student (will be a sophomore in
  267. a couple of weeks) attending Carnegie Mellon University, Pittsburgh,
  268. Pennsylvania, USA, North America, Earth, Solar System, Milky Way..
  269. (DAMN, I hate that joke. But this stupid joke always keeps coming back to
  270. my mind..)
  271.  
  272. Uh well. Anyways, the surest and fastest way to reach me would be through the
  273. Internet.
  274.  My internet e-mail address is:
  275.   Esak+@cmu.edu
  276.  
  277.  
  278. Let me know if you have any problems, questions, comments, etc. I will
  279. do my best to reply, but don't get upset if you don't get any. Flames,
  280. outrageous requests, and questions like "I don't know C. What can I do?"
  281. etc, will most likely be ignored. If you need a coder or an artist, don't
  282. hesistate to contact me, especially if it's a paying job. |-)
  283.  
  284.  
  285. If you don't have an internet account, or would like to send me a postcard,
  286. a Lamborghini, a chunk of fissionable material, or an alien facehugger, use
  287. the following address. (Valid for 1994-95 school year)
  288.  
  289.    1060 MOREWOOD AVE.
  290.    Box No. 1504
  291.    PITTSBURGH PA 15213
  292.    USA
  293.  
  294.  
  295. The alternate mailing address follows. It's the address of my uncle and
  296. aunt's home.
  297. Just make sure you use my real name (Hyun Yim) so they can forward the mails
  298. correctly.
  299.  
  300.    37 Blanan Drive
  301.    Chicopee, MA 01020-4803
  302.    USA
  303.  
  304.  
  305.  
  306. Excuse any spelling or grammatical or logical errors.
  307. English is not my first language and it's hard to think clearly at 5:00AM.
  308.  
  309. Thanks to Draeden of VLA. I didn't use his routines. But his palette
  310. rotation code gave me the idea to code my own.
  311.  
  312. What else... oh yeah, I used TC++3.0 and TASM 4.0. Use /m2 option when
  313. compiling with TASM.
  314.  
  315. Well, that's it for now. Watch out for my first game which will be released
  316. sometime before the end of this millenium.
  317.  
  318.  
  319. Esak (aka Hyun Yim aka Attila the Hyun)
  320.  
  321. ═════════════════════════════════════════════════════════════════════════
  322.  
  323. My friends are toys. I make them.
  324.  
  325.   - JF Sebastian, from _BladeRunner_
  326.  
  327.  
  328.  
  329. My sister and I were driving along the other day when she asked me, what
  330. would I like for my computer.
  331.     I thought long and hard about it, and came up with the following
  332. hypothesis. When a girl gets a Barbie doll, she then wants the extra 
  333. ballgown for the doll, then the hairbrush, and the car, and the house, 
  334. and the friends etc.
  335.     When a guy gets a computer, he wants the extra memory, the bigger 
  336. hard drive, the maths co-pro, the better motherboard, the latest software, 
  337. and the bigger monitor etc.
  338.     I told my sister all of this, and finished up with : "So as you can 
  339. see, computers are Barbie dolls for MEN!"
  340.     She called me a chauvinist. And hit me. Hard.
  341.  
  342.    - Grant Smith, aka DENTHOR of Asphyxia
  343.